ЗАКРИТТЯ ДЕСКРИПТОРА¶

Дескриптор закривається, коли його вилучає засіб збирання сміття у системі. Оскільки дескриптори libguestfs у значній мірі керуються станами, можна закрити (і отже, звільнити) дескриптор явним чином, викликавши метод "close".

ВИНЯТКИ¶

Помилки функцій libguestfs пов'язуються із виключенням "LibGuestFSException". Виключення містить єдиний параметр, яким є повідомлення про помилку (параметр "String").

Спроба викликати будь-який метод для закритого дескриптора призведе до надсилання однакового виключення.

Якщо у прив'язках станеться помилка malloc(3) або якоїсь іншої функції отримання пам'яті, буде надіслано виключення "LibGuestFSOutOfMemory".

ПОДІЇ¶

З боку Java реалізовано повну підтримку програмного інтерфейсу подій libguestfs. Створіть клас, який реалізує інтерфейс "EventCallback", створіть екземпляр цього класу, а потім викличте метод "GuestFS#set_event_callback" для реєстрації цього екземпляра. Метод "event" класу викликається, коли libguestfs створює повідомлення про подію.

Наприклад, такий код виводить усі події трасування:

 GuestFS g = new GuestFS ();
 g.set_trace (true);
 g.set_event_callback (
   new EventCallback () {
     public void event (long event, int eh,
                        String buffer, long[] array) {
       System.out.println (GuestFS.eventToString (event) +
                           ": " + buffer);
     }
   },
   GuestFS.EVENT_TRACE);
 g.add_drive_ro ("disk.img");
 // тощо

Виведені дані будуть подібними до таких:

 EVENT_TRACE: add_drive_ro "disk.img"
 EVENT_TRACE: add_drive_ro = 0
 // тощо

НЕОБОВ'ЯЗКОВІ АРГУМЕНТИ¶

Деяким методам передається необов'язкова карта додаткових параметрів. Прикладом таких методів є метод "g.add_drive", який можна викликати в один з двох способів:

 g.add_drive ("disk.img");

або за допомогою додаткових аргументів:

 Map<String, Object> optargs =
   new HashMap<String, Object>() {
   {
     put ("readonly", Boolean.TRUE);
     put ("format", "raw");
   }
 };
 g.add_drive ("disk.img", optargs);

Щоб дізнатися більше про цю тему, див. "ВИКЛИКИ ІЗ НЕОБОВ'ЯЗКОВИМИ АРГУМЕНТАМИ".

Необов'язкові параметри дескриптора

При створенні дескриптора ви також можете передати карту необов'язкових параметрів:

 Map<String, Object> optargs =
   new HashMap<String, Object>() {
   {
     put ("close_on_exit", Boolean.FALSE);
     put ("environment", Boolean.TRUE);
   }
 };
 GuestFS g = new GuestFS (optargs);

Докладніший опис можна знайти тут: "guestfs_create_flags" in guestfs(3).